home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 7 / Amiga Format AFCD07 (Dec 1996, Issue 91).iso / serious / shareware / comms / non-internet / samba / docs / testprns.0 < prev    next >
Text File  |  1996-07-01  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. TESTPRNS(1)                  testprns                 TESTPRNS(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        testprns - check printer name for validity with smbd
  9.  
  10. SSYYNNOOPPSSIISS
  11.        tteessttpprrnnss _p_r_i_n_t_e_r_n_a_m_e [ _p_r_i_n_t_c_a_p_n_a_m_e ]
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        This program is part of the Samba suite.
  15.  
  16.        tteessttpprrnnss  is  a  very  simple  test  program  to determine
  17.        whether a given printer name is valid for use in a service
  18.        to be provided by ssmmbbdd..
  19.  
  20.        "Valid"  in this context means "can be found in the print-
  21.        cap specified". This program is very stupid - so stupid in
  22.        fact  that it would be wisest to always specify the print-
  23.        cap file to use.
  24.  
  25. OOPPTTIIOONNSS
  26.        _p_r_i_n_t_e_r_n_a_m_e
  27.  
  28.           The printer name to validate.
  29.  
  30.           Printer names are taken from the first  field  in  each
  31.           record  in  the printcap file, single printer names and
  32.           sets of aliases separated by vertical  bars  ("|")  are
  33.           recognised.  Note that no validation or checking of the
  34.           printcap syntax is done beyond that required to extract
  35.           the  printer  name.  It  may be that the print spooling
  36.           system is more forgiving or less forgiving  than  tteesstt--
  37.           pprrnnss  however  if  tteessttpprrnnss finds the printer then smbd
  38.           should do as well.
  39.  
  40.  
  41.        _p_r_i_n_t_c_a_p_n_a_m_e
  42.  
  43.           This is the name of the printcap file to search for the
  44.           given printer name in.
  45.  
  46.           If no printcap name is specified, tteessttpprrnnss will attempt
  47.           to scan the printcap file  specified  at  compile  time
  48.           (PRINTCAP_NAME).
  49.  
  50. FFIILLEESS
  51.        //eettcc//pprriinnttccaapp
  52.           This  is usually the default printcap file to scan. See
  53.           pprriinnttccaapp((55))))..
  54.  
  55. EENNVVIIRROONNMMEENNTT VVAARRIIAABBLLEESS
  56.        Not applicable.
  57.  
  58.  
  59. IINNSSTTAALLLLAATTIIOONN
  60.        The location of the server and  its  support  files  is  a
  61.  
  62.  
  63.  
  64. testprns                    17/1/1995                           1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TESTPRNS(1)                  testprns                 TESTPRNS(1)
  71.  
  72.  
  73.        matter for individual system administrators. The following
  74.        are thus suggestions only.
  75.  
  76.        It is recommended that the tteessttpprrnnss program  be  installed
  77.        under the /usr/local hierarchy, in a directory readable by
  78.        all, writeable only by root. The program  should  be  exe-
  79.        cutable  by all.  The program should NOT be setuid or set-
  80.        gid!
  81.  
  82. VVEERRSSIIOONN
  83.        This man page is (mostly) correct for  version  1.9.00  of
  84.        the  Samba  suite,  plus some of the recent patches to it.
  85.        These notes will necessarily lag behind development of the
  86.        software,  so it is possible that your version of the pro-
  87.        gram has extensions or  parameter  semantics  that  differ
  88.        from  or  are  not covered by this man page. Please notify
  89.        these to the address below for rectification.
  90.  
  91. SSEEEE AALLSSOO
  92.        pprriinnttccaapp((55)),, ssmmbbdd((88)),, ssmmbbcclliieenntt((11))
  93.  
  94. DDIIAAGGNNOOSSTTIICCSS
  95.        If a printer is found to be valid,  the  message  "Printer
  96.        name <printername> is valid" will be displayed.
  97.  
  98.        If  a printer is found to be invalid, the message "Printer
  99.        name <printername> is not valid" will be displayed.
  100.  
  101.        All messages that would normally be logged  during  opera-
  102.        tion  of  smbd  are  logged  by  this  program to the file
  103.        _t_e_s_t_._l_o_g in the current directory.  The  program  runs  at
  104.        debuglevel  3,  so  quite extensive logging information is
  105.        written. The log should be checked  carefully  for  errors
  106.        and warnings.
  107.  
  108.        Other messages are self-explanatory.
  109.  
  110. BBUUGGSS
  111.        None known.
  112.  
  113. CCRREEDDIITTSS
  114.        The  original  Samba  software  and related utilities were
  115.        created by Andrew Tridgell (samba-bugs@anu.edu.au). Andrew
  116.        is also the Keeper of the Source for this project.
  117.  
  118.        The  testprns  program  and  this man page were written by
  119.        Karl Auer (Karl.Auer@anu.edu.au)
  120.  
  121.        See ssaammbbaa((77)) ffoorr aa ffuullll lliisstt ooff ccoonnttrriibbuuttoorrss  aanndd  ddeettaaiillss
  122.        ooff hhooww ttoo submit bug reports, comments etc.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. testprns                    17/1/1995                           2
  131.  
  132.  
  133.